Royalty Templates 分润模板
通过创建 royalty_template 对象来设置一个分润模板。分润模板定义了分润的规则,在创建 order 时传入 royalty_template 对象的 id,在订单付款完成和退款完成时,Ping++ 会根据模板的规则计算分润的用户和金额完成清分。 分润模板依赖于订单层级链,只能给层级链上的商户分润。如果分润规则复杂或者需要给个人用户分润,则分润模板不适用。
| 属性 | 描述 | 
|---|
| id string | 分润模板对象 ID,由 Ping++ 生成。 | 
| object string | 值为 royalty_template。 | 
| app string | 对应 app对象的id,查看如何获取App ID。 | 
| name string | 分润模板名称,允许中英文等常用字符,取值范围 2~50 位。 | 
| created timestamp | 创建时间,用 Unix 时间戳表示。 | 
| rule[royalty_mode] string | 分润模式。值为 rate表示按订单金额(包含优惠券金额)比例计算;值为fixed表示按固定金额收取分润。 | 
| rule[refund_mode] string | 退分润模式。值为 no_refund表示不退分润;值为proportional表示按退款占支付的比例退分润;值为full_refund表示一旦退款成功分润全退。 | 
| rule[allocation_mode] string | 分配模式。表示当订单确定的层级如果少于模板配置层级时,模板中计算出的多余分润金额是归属于收款方: receipt_reserved或服务方:service_reserved。 | 
| rule[data] list | 分润数据列表,详见下方 rule[data]列表属性说明。 | 
| description string | 附加说明,最多 100 个 Unicode 字符。 | 
| rule[data] 列表属性 | 描述 | 
|---|
| level integer | 商户层级,值为 0~5,其中 "0" 表示平台。 | 
| value integer | 分润数值。 royalty_mode为rate时,取值范围 0~10000,单位为 0.01%;royalty_mode为fixed时,取值范围 0~1000000,单位为分。 |